home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbimp12.zip / PCBMPORT.DOC < prev    next >
Text File  |  1993-04-08  |  5KB  |  119 lines
  1.                                   PCBMPORT v1.2
  2.                         FREEWARE (C) 1993 Vince Sorensen
  3.                                All Rights Reserved
  4.  
  5.  
  6. I needed a program to not only copy descriptions from captured
  7. directory listings for files I downloaded, but also one to check
  8. for FILE_ID.DIZ and use that instead if it was there. I wanted
  9. current file sizes, and tomorrow's date. I didn't need the files
  10. to be moved from directory to directory. I found programs that did
  11. one or the other, but not both, so I wrote one.
  12.  
  13. What does this program do?
  14.  
  15.    Checks a directory for files. For all files found, it checks
  16. to see if they contain a FILE_ID.DIZ. If so, it adds the description
  17. to a text file, in PCBoard format. If not, it checks a text file
  18. (or text files) that contain PCBoard format descriptions (which
  19. may have been captured from a download session, or are from a
  20. CD-ROM/BBS file listing). If a description is found there, it
  21. is added to the description text file, with an updated size field.
  22. If not, a description of "No Description Found" is added to the
  23. description text file, again in PCBoard format. All additions to
  24. the description text file are dated with tomorrow's date.
  25.    Optionally, you can add the description that was found, plus
  26. a small message to the archive.
  27.  
  28.  
  29. Requirements:
  30.    If handling .ARJ files, you need ARJ.EXE. If handling .ZIP files,
  31. you need PKUNZIP.EXE. If handling .LZH programs, you need LHA.EXE.
  32.  
  33. Command line options (DIFFERENT THAN VERSION 1.1!):
  34.  
  35. PCBMPORT INT=YES    - run program interactively
  36. PCBMPORT ?          - show syntax
  37. PCBMPORT            - run program in batch mode; PCBMPORT.INI
  38.                       contains the options
  39.  
  40.  
  41. PCBMPORT.INI should contain the following lines:
  42.  
  43. D=Directory      Directory to Search
  44.  
  45. I=Import_File    File to search for descriptions for files without FILE_ID.DIZ
  46.  
  47. E=Export_File    File to place found descriptions in (unless redirected)
  48.  
  49. S=Smart_On_Off   Whether or not to redirect the files and descriptions according
  50.                  to keywords found in the descriptions
  51.  
  52. R=Recheck_On_Off Whether or not to try to find descriptions for files that
  53.                  already exist in the listing being exported to (default
  54.                  export file only)
  55.  
  56. DIZ=Add_Diz      Yes or no; Create FILE_ID.DIZ from description found in
  57.                  text file, and add to archive?
  58.  
  59. MSG=Add_Msg.txt  A text file to add to the archive        (OPTIONAL)
  60.  
  61. SPEC=Add_line    A line to add to the newly created FILE_ID.DIZ (gets added
  62.                  as FILE_NFO.DIZ instead) (does not apply to files that
  63.                  already contain a FILE_ID.DIZ)           (OPTIONAL)
  64.  
  65. SKIPEXT=Yes_No   Yes or no; when searching for descriptions, ignore if the
  66.                  extensions don't match (In other words, if this is set to
  67.                  Yes, the program being looked for is EGG.ZIP and the
  68.                  description found is for EGG.ARJ, the description WILL be
  69.                  used.)                                   (OPTIONAL)
  70.  
  71.  
  72. For example, your PCBMPORT.INI may look like this:
  73.  
  74. D=c:\pcb\upload
  75. I=c:\text\capture.cap
  76. E=c:\pcb\main\private.
  77. S=ON
  78. R=OFF
  79. DIZ=NO
  80.  
  81.  
  82. Memory Management Options:
  83.    This program comes with a built in memory manager. You can set or disable
  84. options on it by setting the environment variable CLAVM before running the
  85. program, or by adding a CLAVM= line to your PCBMPORT.INI.
  86.  
  87. SET CLAVM=OFF       - turn off manager; use convential memory only
  88. SET CLAVM=NOEMS     - swap to disk only; do not use EMS/XMS
  89. SET CLAVM=XMSxxxx   - xxxx is the amount of extended memory to use in kilobytes
  90. SET CLAVM=EMSxxxx   - xxxx is the amount of expanded memory to use in kilobytes
  91. SET CLAVM=          - normal operation
  92.  
  93. If you are running under DesqView or some other multi-tasker, I recommend that
  94. you use the SET CLAVM=NOEMS option.
  95.  
  96.  
  97.  
  98. NOTE:
  99.  
  100. THIS PROGRAM IS FREEWARE - NO FEE MAY BE CHARGED FOR IT. NO WARRANTY IS GIVEN
  101. OR IMPLIED.
  102.  
  103. AUTHOR INFORMATION:
  104.           Vince Sorensen
  105.           6 Armstrong Bay
  106.           Regina, Sask. Canada
  107.           S4N 4G7
  108.  
  109.           BBS 306-789-8682 or 306-789-8690
  110.  
  111.  
  112. History -  Version 1.2  April 7, 1993 Added INI file, options to add DIZ,
  113.                         etc., and sped up description search process.
  114.            Version 1.1  March 18, 1993 Fixed only bug: did not search
  115.                         correct directory for import text files if they
  116.                         were not located in the same directory as the
  117.                         files being described
  118.            Version 1.0  March 17, 1993 First Release
  119.